home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / 8bit / cislib_a / cioequ.doc < prev    next >
Text File  |  1995-04-22  |  1KB  |  31 lines
  1. CIO EQUATES FILE
  2.  
  3. While you program with your Atari, you will frequently use 
  4. input and output operations, and you will invariably use CIO 
  5. to do these operations (except for specialized operations, in 
  6. which case you may use something like SIO).  CIO has many 
  7. labels associated with it such as ICCMD and ICAX1, which you 
  8. will use often.  But if you EQUate these labels in different 
  9. routines, the Kyan Macro Assembler (AS) will hand you a 
  10. 'multiply defined label' error, so you must equate these 
  11. labels globally (which means right after your global VARiable 
  12. declarations).
  13.  
  14. I have created an include file, CIOEqu.i, to make these 
  15. global equates, which may then be used by assembly language 
  16. routines throughout your program.  It is not an all-
  17. encompassing file--that is, it does not contain equates for 
  18. every CIO label and command number, just most of the more 
  19. commonly encountered ones.  You may, of course, add missing 
  20. labels and commands to this file.
  21.  
  22. This file should generally be the first one that you include 
  23. after your global VARiable declarations, since its labels may 
  24. be used by other included routines.  The function GetCha is a 
  25. routine that makes use of CIOEqu.i.  It is available in this 
  26. data library under the filenames GETCHR.DOC and GETCHR.PAS.
  27.  
  28. (CIOEQU.PAS should be renamed to CIOEQU.I after you download 
  29. it.)
  30.  
  31.